1. 為什麼要學 Git，可以做什麼呢?

學習到現在大家一定累積很多的程式碼或是各式的檔案，如何去做有效的控管其實是非常重要！

想像有個情境是你上線了一段程式碼，但顧客抱怨使用上有問題，你需要緊急還原到上一版，這是就可以靠 Git 來協助你進行程式碼或檔案版控，快速還原上一版，就不用急忙打電話給同事找程式碼。我們可以利用 Git 指令將程式碼每次的版本記錄起來，當哪一天需要回頭檢視的時候就可以直接查看。

2. 環境設定

安裝 Git

• Windows
• MacOS

  brew install git
  

終端機常用指令簡介

由於 Git 指令是打在終端機，因此有必要認識一下基本的終端機指令。
以下指令在 MacOs 與 Linux 通用

絕對路徑與相對路徑

• 絕對路徑：/usr/lib
• 相對路徑： 若系統目前在 /usr/lib 這個目錄，可以用 cd ../bin 切換到 /usr/bin

目錄相關

• . 代表此層的目錄
• .. 代表上層的目錄
• ~ 代表自己的家目錄

更詳細資訊

鳥哥的 Linux 私房菜-第六章、Linux 檔案與目錄管理

設定 Git Config

設定帳號名稱和信件

$ git config --global user.name "your github id"
$ git config --global user.email "your email@gmail.com"

查看設定的資訊，按Ｑ可以離開

git config --list

3. Git 工作流程

• git add 會將檔案從工作目錄推到暫存區
• git commit 會將檔案從暫存區推到本地端儲存庫
• git push 會將檔案從本地端儲存庫推到遠端儲存庫
• git pull 會將檔案從遠地端儲存庫同步回工作目錄
• git fetch 會將檔案從遠地端儲存庫同步回本地端的儲存庫
• git merge 合併

4. 開始使用 Git

(1) 查看狀態

使用 git status ，我們可以查看目前修改了什麼檔案(modified)、刪除什麼檔案(deleted)以及哪些檔案尚未被追蹤(Untracked files)

新增一個 test.txt 檔案，會在 Untracked files 列出

(2) git add

使用 git add 檔案 ，我們將檔案或資料夾推到暫存區，若我們再用一次 git status 就會發現有提示一個新檔案(new file)

不建議使用 git add *，這個動作雖然可以一次把所有檔案加上，但可能會加到你不要的檔案(除非你有確定，不要的檔案類型可以寫 .gitignore )

這裡有 python gitignore 的 template 就不用自己辛苦打文件XD

(3) git reset

假設剛剛的檔案反悔不想要放到暫存區或是等一下教的commit要取消， 操作git reset 即可

可以利用 git log 查詢紀錄，也可以直接某一次的版號
git reset 號碼(前6碼即可)

(4) git commit

接著就可以進行提交 commit， 操作git commit -m "這次提交想要傳達的訊息"
為了讓每次的提交都知道在做什麼，會寫有意義的內容(你或你的同事要看Ｒ)，記得訊息一定要寫！！

通常我們訊息為了要分別，有一些原則可以參考，會將下列中括號替換成下面的文字

更改訊息

• 改最後一次
  利用 --amend 來修改 git commit 的訊息
  git commit --amend -m "Hello World!"
• 改之前
  利用 git rebase commit_id號碼(6碼即可) 來修改 git commit 的訊息
  • 先看 git log 知道 commit id
    
  • 輸入 git rebase
  • 進入 vim 編輯器進行修改
    會顯示從現在到這個 commit id 的所有 commit 紀錄
    將 pick 改成 reword 或是 r ，並修改後面的訊息

    按 i 進入編輯模式 
    按 esc 輸入 :wq! 存擋離開
    

    
    
  • 會再進人第二次 vim 編輯器
    再輸入一次

看起來只有簡單改訊息，但大家可以看 commit id 都變了，實際上是修改一個 commit
基本上不建議大家用這招，因為把過去訊息改掉可能會造成錯亂呀！

(5) git push

接著就可以將本地端程式碼推到遠端啦！操作 git push

5. 分支 (Branch)

Git Flow

有人制定了規則讓大家一起遵守
https://nvie.com/posts/a-successful-git-branching-model/

用比較簡單的流程跟大家說明

• main: 穩定、可以上線的版本，而且這個版本只能從別的分支合併過來，基本上開發者不能直接對這個分支進行 commit
• develop: 這個分支紀錄所有開發者的基礎分支，所有的 feature 分支必須從此分支切出，而 feature 分支完成後也都會合併回來此分支
• feature: 新增功能的意思，通常我們會從 develop 分支切出來，並加上此次要新增的功能。 feature/名稱，名稱通常可以取有意義的名稱，讓專案或其他成員可以看懂你這次要幹麼。

查看分支

git branch -a

• 星號代表你現在在哪一個分支
• 按 Q 可以離開
• remote/origin/HEAD -> origin/main 本地端追蹤分支
• remote/origin/develop -> 遠端分支 develop
• remote/origin/main -> 遠端分支 main
• origin 是遠端儲存庫的別名，可以 git remote -v 查看遠端儲存庫的路徑

新增分支

git branch <branch name>
git checkout -b <branch name>

刪除分支

git branch -d <branch name>

切換分支

git checkout <branch name>

合併分支

git merge <branch name>
更詳細的說明：https://gitbook.tw/chapters/branch/merge-branch.html

遠端協作

• 拉遠端分支
  git checkout origin/develop -b develop
• FETCH
  可以更新遠端儲存庫的資料在本地端 git fetch
  
  基本上對本地端的 main 來說 origin/main 也是一種分支，結果在 fetch 之後 main 居然落後 origin/main，這時候就可以利用合併分支 git merge origin/master
  
• PULL
  • git pull
    這個指令也是更新遠端儲存庫的資料在本地端，而這個指令的功用是 git pull = git fetch + git merge ，會自動幫你做完 merge 快轉模式（Fast Forward）的步驟
  • git pull --rebase 加上此參數之後會自動做 rebase
    多人開發的時候，大家會在自己分支commit並在遠端協作，你拉回本地端的時候也會因為合併而產生一個額外的commit，如果你不想要這個多餘的commit可以加上此參數

衝突

假設你與同事或專案成員共用開發，你的同事在 develop 分支上先改了一下操作(這邊遠端用 master 示範)

但你的 local 端，沒有先更新到最新，也對同一行程式碼進行編輯修改。你一樣先 git add 、 git commit，當你發現 git push 時候悲劇了！

怎麼會有衝突呢？ 這時候什麼東西

衝突發生在不同的分支紀錄要合併時，發現居然不同的狀況。 git 很貼心會把衝突的部分秀出來，這時候好好找你同事聊一聊討論一下要改成什麼吧！把標記刪除再重新推一次就可以解衝突囉！

把標記刪除再重新推一次就可以解衝突囉！

6. 標籤 (Tag)

列出標籤

git tag

建立標籤

git tag -a v1.5 -m "my version 1.5 and it add some ..."

查看標籤資訊

git show v1.5

分享標籤

• git push 指令預設不會將標籤傳送到遠端伺服器，你必須要用以下指令才能推送
  git push origin v1.5
• 傳送多個標籤
  git push origin --tags
• 參考資訊

7. 其他操作

(1) 刪除檔案

你可以直接砍檔案 rm 檔案

把特！你會看到這個

因此你要繼續做 git add 和 commit 的動作

484很麻煩！！所以貼心的 git 有這個功能 git rm 檔案 可以一鍵呵成

（2）更換檔名

跟剛剛一樣，你可以使用 mv 指令換檔名然後再 add commit

但 git 一樣有提供一鍵呵成 git mv 原檔名或路徑 新檔名或路徑 可以一鍵呵成

8. Github 參考

https://github.com/erik1110/Data-Science/tree/master/09_Git_Tutorial